Galileo Computing < openbook > Galileo Computing - Professionelle Bücher. Auch für Einsteiger.

...powered by www.netzwerkartist.de...

 << zurück
Visual C# 2005 von Andreas Kühnel
Das umfassende Handbuch
Buch: Visual C# 2005

Visual C# 2005
1.320 S., mit 2 CDs, 59,90 Euro
Galileo Computing
ISBN 3-89842-586-X
gp Kapitel 23 Das Drucken (Printing)
  gp 23.1 Ein einführender Überblick
  gp 23.2 Einen Druckauftrag erteilen
    gp 23.2.1 Methoden und Eigenschaften von »PrintDocument«
    gp 23.2.2 Die Ereignisse eines »PrintDocument«-Objekts
    gp 23.2.3 Die Ereignisse »BeginPrint« und »EndPrint«
    gp 23.2.4 Das Ereignis »QueryPageSettings«
    gp 23.2.5 Das Ereignis »PrintPage«
    gp 23.2.6 Das Beenden des Druckauftrags
    gp 23.2.7 Programmbeispiel
  gp 23.3 Seiteneinstellungen mit »PageSettings«
  gp 23.4 Der Drucker als »PrinterSettings«-Objekt
    gp 23.4.1 Mehrere installierte Drucker
    gp 23.4.2 Wichtige Eigenschaften des »PrinterSettings«-Objekts
  gp 23.5 Die Steuerelemente zum Drucken
    gp 23.5.1 Das »PrintDocument«-Steuerelement
    gp 23.5.2 Das »PrintDialog«-Steuerelement
    gp 23.5.3 Das »PageSetupDialog«-Steuerelement
    gp 23.5.4 Das »PrintPreviewDialog«-Steuerelement
    gp 23.5.5 Das »PrintPreviewControl«-Steuerelement
  gp 23.6 Drucken von Grafiken
    gp 23.6.1 Festlegung der Einheiten und Skalierung
    gp 23.6.2 Beispielprogramm zum Drucken einer Grafik
  gp 23.7 Ausdruck von mehrseitigem Text


Galileo Computing

23.5 Die Steuerelemente zum Druckedowntop

Mit PrintDocument, PageSettings und PrinterSettings kennen Sie nun die wichtigsten Klassen, die im Zusammenhang mit dem Drucken stehen. Darüber hinaus werden in der Toolbox von Visual Studio 2005 auch insgesamt fünf Steuerelemente angeboten, die uns mit Ihren Fähigkeiten teilweise erheblich die Programmierung erleichtern. Ich möchte Ihnen diese Controls nun vorstellen.


Galileo Computing

23.5.1 Das »PrintDocument«-Steuerelemendowntop

Dieses Steuerelement, das einen Druckjob wie weiter oben beschrieben kapselt, gehört zu der Gruppe der Steuerelemente, die zur Laufzeit nicht sichtbar sind und deshalb im Komponentenfach einer Form abgelegt werden. Im Eigenschaftsfenster können Sie nur die Eigenschaft DocumentName einstellen. Zur Erinnerung: Das ist der Name des Dokuments, der in einem Meldungsfenster angezeigt wird, sobald mit der Print-Methode der Druckjob gestartet wird.


Galileo Computing

23.5.2 Das »PrintDialog«-Steuerelemendowntop

PrintDialog gehört zu der Gruppe der Standarddialoge. In Kapitel 17 haben wir uns schon mit den Dialogen OpenFileDialog, SaveFileDialog, usw. auseinander gesetzt. PrintDialog ist das letzte zu dieser Gruppe gehörende Steuerelement und ist aus der Klasse System.Windows.Forms.CommonDialog abgeleitet. Es ermöglicht dem Anwender die Auswahl eines Druckers, die Festlegung der Anzahl der Ausdrucke sowie des Druckbereichs (siehe Abbildung 23.2).

Abbildung
Hier klicken, um das Bild zu vergrößern

Abbildung 23.2   Das Dialogfenster »PrintDialog«

Der Dialog wird aufgerufen, um einen Druckjob zu starten. Deshalb ist es auch notwendig, der Eigenschaft Document die Referenz auf den durch das PrintDocument-Objekt beschriebenen Druckauftrag zuzuweisen. Das können Sie sowohl im Programmcode als auch im Eigenschaftsfenster einstellen. Vergessen Sie die Zuweisung, wird eine Ausnahme ausgelöst, weil der Dialog zu seiner Anzeige die Angabe eines Druckers benötigt, der aus der PrinterSettings-Eigenschaft des PrintDocument-Objekts bezogen wird.

Im Eigenschaftsfenster werden neben Document noch weitere Eigenschaftseinstellungen ermöglicht. Diese können Sie der folgenden Tabelle entnehmen.


Tabelle 23.8   Eigenschaften des »PrintDialog«-Steuerelements

Eigenschaft Beschreibung
AllowCurrentPage Aktiviert bzw. deaktiviert die Auswahloption Aktuelle Seite.
AllowPrintToFile Erlaubt die Umleitung des Ausdrucks in eine Datei. Bei der Einstellung true ist das entsprechende Kontrollkästchen des Dialogs aktiviert.
AllowSelection Aktiviert oder deaktiviert das Optionsfeld Seiten von ... bis.
AllowSomePages Aktiviert oder deaktiviert das Optionsfeld Seiten.
Document Der Druckjob, der die Druckereinstellungen liefert.
PrintToFile Gibt an, ob das Kontrollkästchen zum Umleiten des Ausdrucks in eine Datei aktiviert ist oder nicht.
ShowHelp Gibt an, ob eine Hilfsschaltfläche angezeigt wird. Ist der Wert true, muss das Ereignis HelpRequest behandelt werden.
ShowNetwork Gibt an, ob eine Schaltfläche Netzwerk angezeigt wird.
UseEXDialog Gibt an, ob das Dialogfenster im Stil von Windows XP angezeigt werden kann.

Wir wollen uns das Zusammenspiel des PrintDocument- und des PrintDialog-Objekts nun an einem Codefragment ansehen. Die Methode sei der Ereignishandler des Drucken-Menüpunkts. Aufgerufen wird der Dialog mit der Methode ShowDialog. Bekanntermaßen liefert diese Methode einen Rückgabewert aus der Enumeration DialogResult. Dieser entscheidet darüber, ob der Anwender die vorgenommenen Einstellungen übernommen haben möchte oder nicht.


private void mnuDrucken_Click(object sender, EventArgs e) {
  printDialog1.Document = printDocument1;
  if(printDialog1.ShowDialog() == DialogResult.OK)
    printDocument1.Print();
}


Galileo Computing

23.5.3 Das »PageSetupDialog«-Steuerelemendowntop

Das PageSetupDialog-Steuerelement erlaubt die Festlegung der Seitenränder, die Angabe des Papierformats und der Papierquelle sowie die Ausrichtung Hoch- bzw. Querformat zur Laufzeit einzustellen. Dieser Dialog wird üblicherweise über den Menüpunkt Seite einrichten angezeigt.

Abbildung
Hier klicken, um das Bild zu vergrößern

Abbildung 23.3   Der Dialog »Seite einrichten«

PageSetupDialog bezieht Einstellungen des PageSettings- und PrinterSettings-Objekts aus dem PrintDocument-Objekt, das ebenfalls der Eigenschaft Document übergeben werden muss. Neben dieser Eigenschaft werden weitere im Eigenschaftsfenster angezeigt und können dort oder im Programmcode die Anzeigeoptionen beeinflussen.


Tabelle 23.9   Eigenschaften des »PageSetupDialog«-Steuerelements

Eigenschaft Beschreibung
AllowMargins Diese Eigenschaft gibt an, ob zur Laufzeit die Anpassung der Seitenränder aktiviert ist.
AllowOrientation Gibt an, ob die Optionen zur Auswahl des Hoch- und Querformats aktiviert sind.
AllowPaper Legt fest, ob der Bereich Papier des Dialogfelds (Papiergröße und Papierzufuhr) aktiviert ist.
AllowPrinter Legt fest, ob die Druckerschaltfläche aktiviert ist.
Document Der Druckjob, der die Druckereinstellungen liefert.
EnableMetric Ruft einen Wert ab, der angibt, ob in Millimeter angezeigte Randeinstellungen automatisch in oder aus 1/100 Zoll konvertiert werden sollen, oder legt diese fest.
MinMargins Ruft einen Wert ab, der die von den Benutzern auswählbare minimale Randbreite im aktuell eingestellten Maßsystem angibt, oder legt diesen fest.
ShowHelp Gibt an, ob eine Hilfsschaltfläche angezeigt wird. Ist der Wert true, muss das Ereignis HelpRequest behandelt werden.
ShowNetwork Gibt an, ob eine Schaltfläche Netzwerk angezeigt wird.

Änderungen, die an den Einstellungen vorgenommen werden, wirken sich auf das PageSettings-Objekt aus.

Etwas unglücklich ist im Dialog die Handhabung der Einstellung der Ränder gelöst. In Abbildung 23.3 können Sie sehen, dass die Beschriftung suggeriert, es handle sich bei den Einstellungen und der Anzeige links, rechts, oben und unten um Angaben in Millimeter. Das ist nur teilweise richtig. Nehmen Sie Änderungen vor, schließen den Dialog mit OK und öffnen ihn danach erneut, haben sich die Einträge geändert. Die Einträge, auch wenn Sie sie nicht geändert haben, werden als Millimeterangaben interpretiert und per Vorgabe in Zoll umgerechnet. Nur wenn Sie auf Abbrechen klicken, wird die Umrechnung nicht erfolgen.

In unseren Breitengraden, in denen das metrische System bevorzugt wird, sollten Sie zur Vermeidung dieses Effekts unbedingt die Eigenschaft EnableMetric=true einstellen. Die Umrechnung bei Bestätigung mit OK wird dadurch vermieden, und es wird nach dem erneuten Öffnen des Dialogs der gleiche Wert angezeigt. Jetzt handelt es sich wirklich um Millimeterangaben.


Galileo Computing

23.5.4 Das »PrintPreviewDialog«-Steuerelemendowntop

Wollen Sie eine Druckvorschau anbieten? Dann ist das PrintPreviewDialog-Steuerelement das, was Sie in Ihrer Anwendung einsetzen müssen. Der Anwender kann im Fenster die Größenansicht der Druckausgabe nach vorgegebenen Werten verändern, handelt es sich um einen mehrseitigen Druckjob, ist die Anzeige von gleichzeitig bis zu vier Druckseiten möglich.

Die Programmierung ist sehr einfach und der anderer Steuerelemente ähnlich. Voraussetzung ist, dass Sie das Steuerelement mit dem PrintDocument-Objekt in der Eigenschaft Document verbinden, damit es sich mit den notwendigen Informationen versorgen kann. Nur eine weitere Eigenschaft wird im Eigenschaftsfenster angeboten: UseAntiAlias. Setzen Sie diese Eigenschaft auf true, werden Schriften geglättet – allerdings gleichzeitig auch verbunden mit einer Verschlechterung der Performance.

Das Fenster weist eine Schaltfläche mit einem Druckersymbol auf. Damit diese Schaltfläche das ihr angedachte Verhalten zeigt, nämlich das Drucken des Dokuments, muss der Rückgabewert der Methode ShowDialog ausgewertet werden:


private void mnuDruckvorschau_Click(object sender, EventArgs e) {
  printPreviewDialog1.Document = printDocument1;
  if (printPreviewDialog1.ShowDialog() == DialogResult.OK)
    printDocument1.Print();
}

Abbildung
Hier klicken, um das Bild zu vergrößern

Abbildung 23.4   Das »PrintPreviewDialog«-Steuerelement


Galileo Computing

23.5.5 Das »PrintPreviewControl«-Steuerelementoptop

Während das Steuerelement PrintPreviewDialog im Komponentenfach abgelegt wird, weil es nicht in der Form angezeigt wird, ist das nun vorzustellende Steuerelement PrintPreviewControl ein herkömmliches, das zur Laufzeit der Anwendung für den Anwender sichtbar ist und den Bereich der Seitenvorschau anzeigt. Der Vorteil im Vergleich zu PrintPreviewDialog ist, dass Sie damit eine Seiten- bzw. Druckvorschau nach eigenen Vorstellungen realisieren können, die weit über das hinausgeht, was das Steuerelement PrintPreviewDialog anbietet.

Das Steuerelement ist ein direkter Nachfahre der Klasse Control und erbt die Member dieser Basisklasse. Die meisten werden Sie aber zur Programmierung, die ansonsten denkbar einfach ist, nicht benötigen. Sieben spezifische Eigenschaften zeichnen dieses Steuerelement aus, die wir uns alle ansehen wollen.

Die Wichtigste ist die schon bekannte Eigenschaft Document. Solange dieser kein PrintDocument-Objekt zugewiesen wird, kann das PrintPreviewControl nichts anzeigen.

Ein Dokument kann aus mehr als nur einer Seite bestehen. Diesem Thema werden wir uns später noch eingehend widmen. Wenn mehrere Dokumentseiten im Ansichtsbereich angezeigt werden sollen, müssen Sie in den Eigenschaften Rows und Columns angeben, wie viele Reihen und Spalten gleichzeitig dargestellt werden sollen. Standardmäßig sind beide Eigenschaften auf den Wert 1 eingestellt.

Mit der Eigenschaft Zoom kann die Darstellung einer Seite verkleinert oder vergrößert werden. Die volle Größe eines Dokuments entspricht dem Wert 1.0, der Standardwert ist 0,3. Eine Veränderung des Wertes von Zoom bewirkt, dass die Eigenschaft AutoZoom auf false gesetzt wird. Weist diese Eigenschaft true auf, wird die Seitenvorschau des Dokuments so angepasst, dass es noch im Anzeigebereich des Steuerelements dargestellt werden kann.

Die Eigenschaft StartPage gibt bei mehreren anzuzeigenden Seiten die Nummer der ersten Seite an. Dabei steht 0 für die erste Seite. UseAntiAlias dient wie schon beim PrintPreviewDialog zum Glätten von Schriften.


Tabelle 23.10   Eigenschaften des »PrintPreviewControl«-Steuerelements

Eigenschaft Beschreibung
AutoZoom Legt fest, ob die angezeigte Größe des Dokuments so angepasst wird, dass der gesamte verfügbare Bereich ausgefüllt wird.
Columns Sollen mehrere Dokumente des Druckjobs gleichzeitig angezeigt werden, legt diese Eigenschaft die Anzahl der Spalten dafür fest.
Document Gibt an, aus welchem Druckjob (PrintDocument) die Druckinformationen bezogen werden sollen.
Rows Sollen mehrere Dokumente des Druckjobs gleichzeitig angezeigt werden, legt diese Eigenschaft die Anzahl der Zeilen dafür fest.
StartPage Die Eigenschaft gibt bei mehreren anzuzeigenden Seiten die Nummer der ersten Seite an.
UseAntiAlias Mit der Einstellung true werden Schriften geglättet. Die Anzeige wird besser, allerdings verbunden mit einer Verschlechterung der Performance.
Zoom Steuert die Verkleinerung/Vergrößerung des angezeigten Dokuments.

Das Beispielprogramm »Drucken«

Einen eigenen Dialog zur Seitenvorschau zu programmieren, erfordert nicht besonders viel Programmcode und reduziert sich auf einige wenige Zeilen Programmcode, wie im folgenden Beispiel zu sehen ist.

 


// --------------------------------------------------------------
// Beispiel:...\Kapitel 23\Drucken
// --------------------------------------------------------------
...
public partial class Form1 : Form {
  // allgemeine Zeichenroutine zum Zeichnen in die 
  // PictureBox und zur Druckerausgabe
  private void DrawGraphic(Graphics g, int x1, int y1, int x2, int y2) {
  Pen pen = new Pen(Color.Black);
  for (int i = x1; i <= x2; i += 20)
    g.DrawLine(pen, x1, y1, i, y2);
  for (int i = x2; i >= x1; i -= 20)
    g.DrawLine(pen, x2, y1, i, y2);
  }
  private void pictureBox1_Paint(object sender, PaintEventArgs e) {
    this.DrawGraphic(e.Graphics, 0, 0, pictureBox.ClientSize.Width, 
                                pictureBox.ClientSize.Height);
  }
  private void printDocument1_PrintPage(object sender, PrintPageEventArgs e) {
    this.DrawGraphic(e.Graphics, e.MarginBounds.X, 
       e.MarginBounds.Y, e.MarginBounds.Width + 
       e.MarginBounds.X, e.MarginBounds.Height +  
       e.MarginBounds.Y);
  }
  // Menü: Drucken
  private void mnuDrucken_Click(object sender, EventArgs e) {
    if (printDialog1.ShowDialog() == DialogResult.OK)
      printDocument1.Print();
  }
  // Menü: Seite einrichten
  private void mnuSeiteEinrichten_Click(object sender, EventArgs e) {
    pageSetupDialog1.ShowDialog();
  }
  // Menü: Druckvorschau
  private void mnuDruckvorschau_Click(object sender, EventArgs e) {
    if (printPreviewDialog1.ShowDialog() == DialogResult.OK)
      printDocument1.Print();
  }
  // Menü: Druckvorschau (erweitert)
  private void mnuUserDefPrintPreview_Click(object sender, EventArgs e) {
    Form2 frm = new Form2();
    frm.printPreviewControl1.Document = printDocument1;
    frm.ShowDialog();
  }
}
public partial class Form2 : Form {
  private void btnGroesser_Click(object sender, EventArgs e) {
    try
    {
      printPreviewControl1.Zoom += 0.05;
    }
    catch { }
  }
  private void btnKleiner_Click(object sender, EventArgs e) {
    try
    {
      printPreviewControl1.Zoom -= 0.05;
    }
    catch { }
  }
  private void btnAuto_Click(object sender, EventArgs e) {
    printPreviewControl1.AutoZoom = true;
  }
}

Abbildung
Hier klicken, um das Bild zu vergrößern

Abbildung 23.5   Das Hauptfenster des Beispiels »Drucken«

Abbildung
Hier klicken, um das Bild zu vergrößern

Abbildung 23.6   Der Dialog der erweiterten Druckvorschau

 << zurück
  
  Zum Katalog
Zum Katalog: Visual C# 2005
Visual C# 2005
bestellen
 Ihre Meinung?
Wie hat Ihnen das <openbook> gefallen?
Ihre Meinung

 Buchtipps
Zum Katalog: Fortgeschrittene Programmierung mit Visual C# 2005






 Fortgeschrittene
 Programmierung
 mit Visual C# 2005


Zum Katalog: Einstieg in Visual C# 2005






 Einstieg in
 Visual C# 2005


Zum Katalog: Einstieg in Visual Basic 2005






 Einstieg in
 Visual Basic 2005


Zum Katalog: Visual Basic 2005






 Visual Basic 2005


Zum Katalog: Java ist auch eine Insel






 Java ist auch eine
 Insel


Zum Katalog: Konzepte und Lösungen für Microsoft-Netzwerke






 Konzepte und
 Lösungen für
 Microsoft-Netzwerke


 Shopping
Versandkostenfrei bestellen in Deutschland und Österreich
InfoInfo








Copyright © Galileo Press 2006
Für Ihren privaten Gebrauch dürfen Sie die Online-Version natürlich ausdrucken. Ansonsten unterliegt das <openbook> denselben Bestimmungen, wie die gebundene Ausgabe: Das Werk einschließlich aller seiner Teile ist urheberrechtlich geschützt. Alle Rechte vorbehalten einschließlich der Vervielfältigung, Übersetzung, Mikroverfilmung sowie Einspeicherung und Verarbeitung in elektronischen Systemen.


[Galileo Computing]

Galileo Press, Rheinwerkallee 4, 53227 Bonn, Tel.: 0228.42150.0, Fax 0228.42150.77, info@galileo-press.de